---
title: 'Cypress.platform | Cypress Documentation'
description: Get the underlying OS name as returned from Node's os.platform() in Cypress.
sidebar_label: platform
---

<ProductHeading product="app" />

# Cypress.platform

`Cypress.platform` returns the underlying OS name, as returned from Node's
[`os.platform()`](https://nodejs.org/api/os.html#os_os_platform).

Even though Cypress runs in the browser, it automatically makes this property
available for use in your tests.

## Syntax

```javascript
Cypress.platform // 'darwin'
```

## Examples

### Conditionals

```javascript
it('has JSON files', () => {
  // if windows do one thing, else do another
  const cmd = Cypress.platform === 'win32' ? 'dir *.json' : 'ls *.json'

  cy.exec(cmd).its('stdout').should('include', 'package.json')
})
```
